home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr27 / alcart10.zip / ALACARTE.DOC < prev    next >
Text File  |  1995-04-16  |  21KB  |  485 lines
  1.         alaCARTE               Warner Instruments               page 1
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                             alaCARTE   version 1.00
  17.  
  18.  
  19.                            a simple DOS menu system
  20.  
  21.  
  22.                    Warner Instruments   Grand Haven  MI   49417
  23.  
  24.  
  25.                       ---=== Public Domain Software ===---
  26.         alaCARTE               Warner Instruments               page 2
  27.  
  28.  
  29.  
  30.  
  31.                              ┌──────────────────┐
  32.                              │     CONTENTS     │
  33.                              └──────────────────┘
  34.  
  35.  
  36.                 Contents.......................................2
  37.  
  38.                 Disclaimer.....................................3
  39.  
  40.                 Agreement......................................3
  41.  
  42.                 Public Domain Software.........................3
  43.  
  44.                 Hardware - Software Requirements...............4
  45.  
  46.                 Files..........................................4
  47.  
  48.                 Description....................................5
  49.  
  50.                 How alaCARTE Works.............................6
  51.  
  52.                 Installing alaCARTE............................6
  53.  
  54.                 Using the Menus................................7
  55.  
  56.                 Editing the Menu...............................7
  57.  
  58.                 Changing or Adding Pages.......................8
  59.  
  60.                 Command Line Switches..........................9
  61.  
  62.                 Technical Support.............................10
  63.  
  64.                 Getting the Latest Version of the Program.....10
  65.  
  66.                 Contacting the Author.........................11
  67.  
  68.                 Revision History..............................11
  69.         alaCARTE               Warner Instruments               page 3
  70.  
  71.  
  72.                             ┌────────────────────┐
  73.                             │     DISCLAIMER     │
  74.                             └────────────────────┘
  75.  
  76.  
  77.         Gene Warner is the author of alaCARTE.
  78.  
  79.         Users of alaCARTE must accept this disclaimer of warranty:
  80.  
  81.         "alaCARTE is supplied as is. Gene Warner, and Warner Instruments
  82.         disclaims all warranties, expressed or implied, including, without
  83.         limitation, the warranties of merchantability and of fitness for any
  84.         purpose. The author assumes no liability for damages, direct or
  85.         consequential, which may result from the use of or inability to use
  86.         alaCARTE, even if the author has been advised of the possibility of
  87.         such damages."
  88.  
  89.  
  90.  
  91.                                ┌───────────────┐
  92.                                │   AGREEMENT   │
  93.                                └───────────────┘
  94.  
  95.         alaCARTE is public domain software and is provided at no charge to the
  96.         user. The program is a stand-alone program without any connection to
  97.         specific types or brands of hardware or software.
  98.  
  99.         alaCARTE may be distributed freely by distributors of shareware/user
  100.         supported software, file distribution nets, bulletin boards etc., via
  101.         modems, disks, CD-ROM disks etc., but only if all files are included
  102.         completely and unmodified, preferably in one single archive file.
  103.  
  104.         The alaCARTE program SHOULD NOT be bundled with any piece of hardware
  105.         or software without author recognition.
  106.  
  107.         You are encouraged to pass a copy of alaCARTE along to your friends
  108.         and associates, but please remember to include all files.
  109.  
  110.  
  111.  
  112.                         ┌─────────────────────────────┐
  113.                         │   PUBLIC DOMAIN SOFTWARE    │
  114.                         └─────────────────────────────┘
  115.  
  116.         The essence of "public domain" software is to provide personal
  117.         computer users with quality software without charge.  The author
  118.         of public domain software receives no compensation for his efforts,
  119.         other than the personal satisfaction of creating something that is
  120.         useful to others and, perhaps, a certain amount of recognition.
  121.  
  122.         Public domain software is free, with no strings attached.
  123.         alaCARTE               Warner Instruments               Page 4
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                    ┌──────────────────────────────────────┐
  130.                    │   HARDWARE - SOFTWARE REQUIREMENTS   │
  131.                    └──────────────────────────────────────┘
  132.  
  133.         alaCARTE works on IBM personal computers, or true compatibles, XT
  134.         on up.  Use Dos 3.10 or later. alaCARTE is a DOS application.  It
  135.         can be called from Windows like any other DOS application, but
  136.         really adds nothing to the functionality of Windows.
  137.  
  138.  
  139.  
  140.  
  141.  
  142.                              ┌───────────────────┐
  143.                              │       FILES       │
  144.                              └───────────────────┘
  145.  
  146.         The complete package consists of 7 files:
  147.  
  148.           Filename:     Size:    Date:   Time:    Description:
  149.  
  150.         0.BAT             251  02-28-95  9:45p  Batch file: calls alaCARTE
  151.         INSTALL.BAT      3852  04-16-95  2:46p  Installer
  152.         ADD.DAT            28  06-09-95  3:06p  Call lines for autoexec.bat
  153.         MENU_00.DAT       609  03-30-95  7:01p  Demo menu
  154.         FILE_ID.DIZ       344  04-16-95  3:06p  A short description file
  155.         alaCARTE.DOC   21,172  04-16-95  3:08p  This document
  156.         alaCARTE.EXE   72,899  03-02-95  9:37p  The menu system program
  157.         alaSAVER.EXE   45,248  01-29-95  9:08p  The screen saver program
  158.         alaSAVER.ICO      766  01-14-95  9:12p  Icon for Microsoft Windows
  159.         README.TXT        369  04-09-95  3:51p  Quick Start Instructions
  160.         alaCARTE               Warner Instruments               page 5
  161.  
  162.  
  163.  
  164.  
  165.                              ┌───────────────────┐
  166.                              │    Description    │
  167.                              └───────────────────┘
  168.  
  169.  
  170.         alaCARTE is a simple DOS menuing system.
  171.  
  172.         alaCARTE provides four color-coded menu "Groups" on the screen,
  173.         into which you can enter the title, path and start-up command for
  174.         any program or utility you wish to run.  Having done that, you
  175.         can then call any program you wish simply by selecting the
  176.         group that it's in, and the number associated with its title.
  177.  
  178.         The four different groups allow you to segregate your programs
  179.         in whatever order seems most logical to you.  For example, one
  180.         group might contain "Work Programs", such as your word
  181.         processor, spread sheet and database program.  A second group
  182.         might contain "Utilities", such as your back-up program, virus
  183.         scanner, and comm program.  A third group might contain your
  184.         favorite "Games and Entertainment" programs. The fourth group
  185.         could include regularly used commands ... drop to DOS, load
  186.         MS-Windows, run the screensaver, and so on.
  187.  
  188.         You can use the four groups in any way you wish, and you can
  189.         name them accordingly, or simply accept the defaults; "Group A",
  190.         "Group B", "Group C" and "Group D".
  191.  
  192.         The two groups in the top half of the screen, groups "A" and "B"
  193.         have spaces for nine entries numbered "1" thru "9", while the
  194.         lower two, groups "C" and "D", provide spaces for six items,
  195.         giving a total of thirty items on the menu page.
  196.  
  197.         You'll never run out of room, however, because alaCARTE lets you
  198.         set up 100 menu pages, numbered "0" to "99".  This is especially
  199.         handy when the computer is used by more than one person, as many
  200.         "family computers" are.  Page "0" might contain entries commonly
  201.         used by everyone.  Sonny might keep all his favorite games on
  202.         Page "1", while Sis keeps hers on Page "2". Mom can enter cook
  203.         books, craft programs and the programs she uses for her
  204.         volunteer work on Page "3"; Dad can keep his home office stuff
  205.         on Pages "4" and "5" (and maybe hide his "private files" on Page
  206.         "66").
  207.  
  208.         alaCARTE also displays the current date and time at the bottom
  209.         of every page for your convenience, offers context sensitive
  210.         (F1) help, and provides detailed prompts to guide you in its
  211.         use.
  212.          alaCARTE               Warner Instruments               page 6
  213.  
  214.  
  215.  
  216.                            ┌───────────────────────┐
  217.                            │   HOW alaCARTE WORKS  │
  218.                            └───────────────────────┘
  219.  
  220.         alaCARTE uses two simple batch files to call your programs. The
  221.         main program is an .EXE file, which uses about 74K of your main
  222.         memory.
  223.  
  224.         A small batch file, "0.BAT" is used to initially call the main
  225.         program, ALACARTE.EXE, and then to run the program you select
  226.         using the menus.
  227.  
  228.         If you include "0.BAT" at the end of your AUTOEXEC.BAT file,
  229.         the menus will pop up whenever you boot up your computer, and
  230.         you can also simply pop it up by touching "0" and <Enter>. (If
  231.         you're already using a file named "0.BAT" for something else,
  232.         you may rename alaCARTE's "0.BAT" to anything you want ...
  233.         "M.BAT" or "Z.BAT", for example.)
  234.  
  235.         When you select a program or utility to run from alaCARTE's
  236.         menu, alaCARTE writes "ALACARTE.BAT" to the root directory on
  237.         your hard drive (C:\ALACARTE.BAT).  This three-line batch file
  238.         contains the necessary path and filename, and also the "Page"
  239.         number that you were using. It then exits, leaving only the
  240.         "0.BAT" remnant in your main memory. This system therefore makes
  241.         virtually all of your main memory available, with only about 250
  242.         bytes taken up by the menuing system.
  243.  
  244.         "0.BAT" then calls "ALACARTE.BAT" to find out what program or
  245.         utility you selected, and then runs it. When you exit from that
  246.         activity, "0.BAT" then re-calls alaCARTE, returning you to the
  247.         page you were on when you called the previous program.
  248.  
  249.  
  250.  
  251.                           ┌──────────────────────────┐
  252.                           │   INSTALLING alaCARTE    │
  253.                           └──────────────────────────┘
  254.  
  255.         alaCARTE is programmed to operate from the root directory on
  256.         your hard drive.  After you unzip the archive, copy these two
  257.         files to C:\ ...
  258.  
  259.                                  0.BAT
  260.                                  ALACARTE.EXE
  261.  
  262.         If you want to use the alaSAVER screen saver, which features a
  263.         clock that chimes the hour, and chimes each quarter-hour, you
  264.         may put ALASAVER.EXE in C:\ also, since alaCARTE will look for
  265.         alaSAVER in the root directory by default.
  266.          alaCARTE               Warner Instruments               page 7
  267.  
  268.  
  269.        ┌──────────────────────────  NOTE  ─────────────────────────────┐
  270.        │   You can use any DOS display program you want instead of     │
  271.        │   alaSAVER.  The "Dazzle" programs for example (available on  │
  272.        │   the FireRight bbs and elsewhere), provide interesting and   │
  273.        │   beautiful kaleidoscopic displays.  After a period of        │
  274.        │   inactivity, alaCARTE simply calls whatever program you have │
  275.        │   entered at Group D, Title 6.  By default, this will be set  │
  276.        │   to C:\ALASAVER.EXE.  You can edit this line to run any      │
  277.        │   program you want, and a different one for each page (for    │
  278.        │   variety), if you wish.                                      │
  279.        └───────────────────────────────────────────────────────────────┘
  280.  
  281.        A sample menu file, MENU_00.DAT is also included in the archive,
  282.        and may be copied to your root directory if you want to see an
  283.        example of a "filled in" menu page.  If alaCARTE cannot find
  284.        MENU_00.DAT in your root directory when it starts up for the
  285.        first time, it will create it, automatically filling in some
  286.        default titles.
  287.  
  288.        If you want the menus to pop up when you turn on or reboot your
  289.        computer, add "0.BAT" (or whatever name you have chosen to rename
  290.        this batch file) as the last line in your AUTOEXEC.BAT file. Use
  291.        a text editor or the Windows Notepad accessory to revise your
  292.        AUTOEXEC.BAT file; do not use a word processor which might add
  293.        formatting codes to the file.
  294.  
  295.  
  296.                           ┌───────────────────────┐
  297.                           │    USING THE MENUS    │
  298.                           └───────────────────────┘
  299.  
  300.        To pop up the menus from the C:> prompt, touch the "0" key and
  301.        press <Enter>.  (If you have renamed the "0.BAT" file, enter the
  302.        name you have chosen for it, instead of "0".)
  303.  
  304.        To launch a program or utility shown in one of the menu groups,
  305.        simply highlight that group by touching its letter key ... "A",
  306.        "B", "C" or "D".  After highlighting the group, touch the number
  307.        key associated with the title you wish to select.
  308.  
  309.        That's all there is to it!
  310.  
  311.  
  312.                        ┌────────────────────────────┐
  313.                        │      EDITING THE MENU      │
  314.                        └────────────────────────────┘
  315.  
  316.        To add items to the menu, change menu items or change the names
  317.        of the groups, touch the F10 key to pop up the utilities menu at
  318.        the lower right corner of the screen.
  319.  
  320.        Choose "E"dit, then follow the prompts that alaCARTE provides,
  321.        and answer the questions it asks.  Helps appear on the screen
  322.        that tell you how.
  323.          alaCARTE               Warner Instruments               page 8
  324.  
  325.        alaCARTE first asks you to indicate what Group and Title Number
  326.        you wish to edit. It then asks you to enter a title for the menu.
  327.        Next, you are asked to enter the path to the program or utility
  328.        you wish to add to the menu, and then the name of the file that
  329.        launches it. Finally, you are shown the instruction you have
  330.        entered, and asked to either accept or reject it.
  331.  
  332.        You can abort this process at any time by pressing the Esc key.
  333.  
  334.        To erase a menu item, go into the Edit mode, select the title and
  335.        when asked for a new title simply press enter.  alaCARTE will
  336.        then erase the data for that item and return to its normal mode.
  337.  
  338.        If you select an item, but then decide that you do not want to
  339.        change it, simply press the Esc key. alaCARTE will then restore
  340.        the original data for that title and return to its normal mode.
  341.  
  342.           ┌─────────────────── Exiting to DOS ────────────────────┐
  343.           │                                                       │
  344.           │     alaCARTE fills in a default command for you       │
  345.           │     as item D-5, "DOS Prompt". This totally shuts     │
  346.           │     down the main program and all its batch files,    │
  347.           │     leaving you at the DOS prompt.  If you want to    │
  348.           │     move this line elsewhere, when asked for the      │
  349.           │     directory, enter "C:\", when asked for the        │
  350.           │     file name just press enter (no file name), and    │
  351.           │     when asked if "C:\" is correct, press enter to    │
  352.           │     accept it.                                        │
  353.           │                                                       │
  354.           └───────────────────────────────────────────────────────┘
  355.  
  356.  
  357.  
  358.  
  359.                        ┌──────────────────────────────────┐
  360.                        │     CHANGING OR ADDING PAGES     │
  361.                        └──────────────────────────────────┘
  362.  
  363.        To change to another menu page, or to create a new page, touch
  364.        the F10 key, and select "P"age from the pop up utilities menu.
  365.        You will then be shown what page number you are presently on, and
  366.        asked to enter the number of the page you wish to switch to. Use
  367.        the "Backspace" key and number keys to change the number to the
  368.        number of the new page, then press <Enter>,
  369.  
  370.        If a MENU_nn.DAT file for that page exists, alaCARTE will load
  371.        it. If that page does not exist, alaCARTE will then create it for
  372.        you. The "DOS", "Windows" and "alaSAVER" default titles will be
  373.        entered for you on your new page.  You may change these if you
  374.        wish, and enter any other titles desired.
  375.          alaCARTE               Warner Instruments               page 9
  376.  
  377.                         ┌─────────────────────────────┐
  378.                         │    COMMAND LINE SWITCHES    │
  379.                         └─────────────────────────────┘
  380.  
  381.        alaCARTE can be configured to your particular preferences by
  382.        means of four command line switches:
  383.  
  384.             /S0    disable the screen saver function (on by default).
  385.             /Sn    set the screen saver time out delay to "n" seconds
  386.                    (e.g.: /S90 will set the screen saver to pop up after
  387.                     1-1/2 minutes of inactivity. The default is 300.
  388.  
  389.             /Gx    Start up with Group "x" enabled. Valid choices for
  390.                    "x" are "A", "B", "C" or "D". (all groups will
  391.                    otherwise be off by default).
  392.  
  393.             /Pn    Start up on Page "n". Valid choices for "n" are "0"
  394.                    through "99". (No default; alaCARTE ordinarily
  395.                    returns to the page it was on prior to calling the
  396.                    previous application.)
  397.  
  398.        To use these switches, simply open the "0.BAT" file with a text
  399.        editor or the Windows Notepad accessory and add them on the third
  400.        line, immediately after "alacarte.exe". For example ...
  401.  
  402.                        alacarte.exe /s90/ga/p%page_call%
  403.  
  404.               ... tells alaCARTE to start on the previous page with
  405.        Group A selected, and to activate the screen saver (item D-6)
  406.        after 90-seconds of inactivity.
  407.         alaCARTE               Warner Instruments              Page 10
  408.  
  409.  
  410.  
  411.                            ┌───────────────────────┐
  412.                            │   Technical Support   │
  413.                            └───────────────────────┘
  414.  
  415.         The alaCARTE menuing system is designed especially for "family"
  416.         use, is easy to set up, use, and revise ... even for the kids.
  417.  
  418.         If you cannot get the program to run properly, the following are
  419.         some things you could try to solve the problem.
  420.  
  421.         First make sure that you have installed all the files in the proper
  422.         directory, and that you are calling the program using the correct
  423.         path and filename.
  424.  
  425.         Observe the status bar and the help screens as you use the menus
  426.         making sure that you are using the program as suggested by these
  427.         prompts and helps.
  428.  
  429.         If all else fails, help is available from Warner Instruments.
  430.         You may call us weekdays between 8:00AM and 5:00PM (Eastern
  431.         Standard Time).  Our FAX and Customer Support Bulletin Board are
  432.         available 24-hours a day, seven days a week, and may be used if
  433.         you wish to communicate with us outside of normal working hours.
  434.         We will respond using whatever method you use to contact us.  FAX
  435.         inquiries will be answered by FAX, BBS messages will be answered
  436.         by a reply on the BBS, etc.
  437.  
  438.                   Warner Instruments Voice:  (616) 842-7658
  439.                                        FAX:  (616) 842-1471
  440.                              FireRight BBS:  (616) 842-1471
  441.                                   Internet:  gene.warner@aquila.com
  442.  
  443.  
  444.  
  445.               ┌────────────────────────────────────────────────┐
  446.               │    GETTING THE LATEST VERSION OF THE PROGRAM   │
  447.               └────────────────────────────────────────────────┘
  448.  
  449.         The latest version of the alaCARTE program is always available
  450.         for download on the FireRight BBS, at 616-842-1471.
  451.         alaCARTE               Warner Instruments              Page 11
  452.  
  453.  
  454.  
  455.                          ┌───────────────────────────┐
  456.                          │   CONTACTING THE AUTHOR   │
  457.                          └───────────────────────────┘
  458.  
  459.         Your comments, suggestions, etc. are always welcome.
  460.         You can reach use electronically at ...
  461.  
  462.                   FireRight BBS: 616-842-1471
  463.                Internet:  gene.warner@aquila.com
  464.  
  465.         Otherwise, you may address your comments to ...
  466.  
  467.                         Gene Warner
  468.                         Warner Instruments
  469.                         1320 Fulton Street   PO Box 604
  470.                         Grand Haven  MI   49417-0604   usa
  471.  
  472.  
  473.  
  474.                            ┌──────────────────────┐
  475.                            │   REVISION HISTORY   │
  476.                            └──────────────────────┘
  477.  
  478.         1.0  Released 9 April 1995:
  479.  
  480.             First official release of public domain version
  481.  
  482.  
  483.  
  484.                                       -= * =-
  485.